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This revision of the Debug II User's Manual, 093-000020-02, supersedes 
093-000020-01. It is a minor revision, correcting an error in contents 
of the Carry Register and the omission of Punch commands in the Com- 
mand Summary. The list of pages changed is given at the back of the 
manual. 
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INTRODUCTION 

Data General Corporation's Debug II is a program that interfaces with user routines 
as an aid in debugging. It provides for four active breakpoints within the user's 
routines. The accumulators, Carry and memory locations can be examined and modified 
from the teletypewriter after a breakpoint has occurred. 

The machine state can be monitored during execution of a routine using simple commands 
to Debug II from the teletypewriter. Debug II interfaces with any type of routine, 
including those that use the NOVA family interrupt structure. 

In addition, Debug II can be used to punch ranges of memory in binary format acceptable 
as input to the Binary Loader and to perform desk-calculator type expression evaluations 
at the teletypewriter. 
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FORMAT OF COMMANDS 

Commands to Debug II are of the general form: 



[ argument jc ommand 



where: argument is null, a single digit, an ad- 
dress or an expression. 

command is a single teletype code. 

Argument expressions are of the form: 



octal no. + octal no. + 



where "+" causes octal addition and "-" causes 
octal subtraction. An octal number may be re- 
placed by $, a special symbol meaning "current 
contents of the most recently opened register". 

In the text following, a carriage return will be 
indicated by the symbol j, and a line feed will be 
indicated by the symbol j . 

EXAMINING AND MODIFYING SPECIAL REGISTERS 

Users can examine and modify registers, where 
"registers" denote both memory locations, accumu- 
lators, Carry and certain Debug II registers. 

A register is said to be "open" after it has been 
examined. The options are either to simply "close" 
the register or to alter the current contents of the 
open register by typing new octal contents before closing 
it. 



Accumulators can be examined by the command: 



nA 



where n specifies the accumulator (0-3). Debug II 
responds by typing a slash followed by the octal 
contents of the accumulator. The accumulator 
is now open and may be modified by typing an octal 
expression or may be closed without alteration. 

A ^, closes the open register. To modify the contents 
type the new octal contents followed by ^. 
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EXAMINING AND MODIFYING SPECIAL REGISTERS 



(cont'd) 



0A/ 00(8012 j). 

User opens AC0. Debug II prints the current 
contents (000012), and user closes the 
register. 

2A/ 000017 $+3-10 i. 

User opens AC2. Debug II prints the current 
contents (000017). User modifies the contents 
to 000012 and closes the accumulator. 



The command: 



causes the contents of all four accumulators to be 
printed out. However, the nA command must be 
given if the user wishes to modify the contents of 
an accumulator. 

Other Special Register Commands 

Debug II permits the examination and modification 
of a number of other special registers: 

The command: 



causes the opening and printing of the contents of the 
Carry register. If Carry was set when Debug II 
was entered, the cont 
contents are zeroed. 

The command: 



I 



causes the opening and the printing of the contents 
of the Interrupt Enable register. Bit 15 will be 
set if interrupts were enabled when Debug II was 
entered because of a breakpoint; otherwise, bit 15 
i6 reset. 

The command: 



For example: 
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Other Special Register Commands (cont'd) 

causes the opening and printing of the contents of the 
TTY Done register. Bits 14 and 15 are significant. 
If bit 14 is set, the respective TTO Done flip-flop 
is set. If bit 15 is set, the respective TTI Done flip- 
flop is set. The remainder of register bits will be 
zero. 

The command: 



H 



causes the opening and printing of the contents of the 
Punch Device Register. The register is discussed in 
the section on punch commands. 



EXAMINING AND MODIFYING MEMORY REGISTER S 

(cont'd) 

A memory register is closed by typingj. In addition 
to simply closing the modified or unmodified register, 
the user can close the current register and open the 
succeeding register by striking a line feed (^), or he 
can close the current register and open the preceding 
register by striking f (Shift N keys). 

A memory location can be opened without its current 
contents being printed by the command: 



adr! 



Location adr is now open for modification. 



The command : 



L 



causes the opening and printing of the contents of 
the Starting Location register. The register is 
discussed in the section on run commands. 

The commands: 



W and 


M 



cause the opening and printing of the contents of the 
Word and Mask registers respectively. These registers 
are discussed in the section on search commands. 

The command: 



nN 



causes the opening and printing of the contents of 
Breakpoint Count register n (n = 0, 1, 2, or 3). The 
command is discussed in the section on run commands. 

EXAMINING AND MODIFYING MEMORY REGISTERS 

Any memory location can be opened and examined by 
typing: 



adr/ 



L 



where: adr is the octal address of the desired location, 
or "$" for the contents of the current location, 
or ". " for the address of the most recently 
opened memory register. 

Memory locations are modified in the same manner 
as are special registers, by typing the desired octal 
expression following the printout of the current 
contents. 



When succeeding or preceding locations are opened, 
using | or f , the contents will be printed only if 
the original command was: 



adr/ 



If the original command was: 



adr! 



the contents of the adjacent location being opened will 
not be printed. 



1061/ 01760(3 I 
.! 100000/ 



1271/ 0175501 
016635V 
016331 6331 I 



7661 017600 t 
100000 i 



$/ 016635 I 



-— no modification, 
—open previously closed memory 
register (1061) to alter contents. 



— User opens 1271 and two 

succeeding registers, changing 
the contents of register 1273. 



User opens without examining 
registers 766 and 765 and 
changes the contents of both. 



User examines contents of 
current register. 



MEMORY SEARCH COMMANDS 

The search command is used to search all memory 
or portions of memory for given contents. The 
format of the memory search command is: 
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MEMORY SEARCH COMMANDS (cont'd) 



MEMORY SEARCH COMMANDS (cont'd) 



[adrj] [,adr 2 ] S 



where: adr ^ is the optional octal address of the first 
location to be searched, if both arguments are 
given. 



adr_2 is the optional octal address of the last 
location to be searched. 



When the command S is given without arguments, the 
search begins at location and terminates at 77777. If 
only a single address is given, the search starts at 
location 0, and terminates at the address given by the 
argument. 

The contents are searched for a match with contents 
of the W (word) and M (mask) registers. The W 
register contains the contents to be searched for. The 
mask register contains a mask that is ANDed with the 
location's contents such that a match occurs if: 

W = (adr) A M 

where ( ) means "contents of". 

The word and mask registers are opened by giving 
the commands: 



W 



and 



M 



The response from Debug II is the same as for an 
accumulator. Debug II will print a slash followed 
by the current octal contents of the register. The 
user may then change the contents if desired. 



M /000000^ mask register contains 

W /010000 <fi) word register is set to 

40.710S user obtains printout of all locations 

from 40 through 710. 



M /000000 174000/ 
W /000000 010000/ 

S 



set M to 174000 

set W to 010000 

search all of core for all 
ISZ instructions 



M /174000 177777 
W /(?10g('0(/ 132765 

777S 



set M to 177777 (all ones) 

set W register to word desired 

search from location through 
location 777 for 132675. 



BREAKPOINT COMMANDS 

Breakpoints are key elements of the debugger. They 
permit a user to execute a small portion of his pro- 
gram and then check the program status. A break- 
point is an instruction address at which the user can 
stop program execution, reenter the debugger and 
use the Debug II commands to check the current 
state of his program. The user can set up to four 
breakpoints, using Debug II, 

The command ta set a breakpoint has the format: 



adrB 



where: adr is the octal location at which the breakpoint 
will be set. 

Debug II assigns the address to one of the four break- 
points (numbered to 3), unless all breakpoints are 
active. If all breakpoints are in use, Debug II prints 
out: 



addresses, the command: 



B 



is given. Debug II responds by typing the breakpoint 
number and the location at which the breakpoint is 
set. 

To deactivate all breakpoints, the command: 



D 



can be given. To deactivate a single breakpoint, the 
command: 



nD 



is given, where n is the number of the breakpoint 
(0 through 3). 



ni:iiu; 11 
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BREAKPOINT COMMANDS (cont'd) 

When the user transfers from the debugger to his 
program for execution (see next section, Run Com - 
mands), the program will execute until an instruction 
at which a breakpoint is set is encountered. Execution 
halts before the breakpoint instruction is executed, 
anil control transfers to Debug II. Debug II prints out: 

adrB n 

on the teletype, where: 

adr is the breakpoint address and 
n is the breakpoint number. 

Debug II then prints the contents of all accumulators. 
The user can examine further the current machine 
state using any of the Debug II commands. 

If the user examines the breakpoint address he will 
find the proper contents of his program, since 
Debug II replaces the active breakpoint upon debugger 
entry with the original contents of the address, 
leaving the breakpoints invisible to the user. However, 
if the user routine executes a HALT or transfers 
wildly, the breakpoints can be seen by examining the 
addresses from the control console. 



BREAKPOINT COMMANDS (cont'd) 

4. The breakpoint should not be placed at a point 
where interrupts cannot be held off for a 
long period of time, since Debug II executes 
an INTDS upon entry. 

5. The breakpoint should not be placed in an 
interrupt routine after an INTEN instruction, 
since another interrupt may occur and destroy 
location before Debug II gains control. 

6. The breakpoint cannot be placed on any 
instruction that enables or disables interrupts, 
i.e., INTDS. 

Examples of setting and using breakpoints are included 
in the next section, Run Commands. 

RUN COMMANDS 

The user can transfer control from Debug II to the 
user routine with the command: 



Ladr] R 



where: adr is an optional location to which control 
is transferred. 



The breakpoint will appear as the instruction: 



IMP (<Dln 



where: n is the number of the breakpoint; 

IX- bug II uses locations 10 through 13 of 
page to store address entry points to 
itself. 

Caution should be used in the placement of break- 
points. If an arbitrarily complex subroutine could 
be transferred to at the breakpoint, the user should 
have no difficulty (since this is what actually happens). 
The following restrictions should, however, be noted: 

1. The breakpoint should never be placed at a data 
word (since these words are never executed. ) 

2. The breakpoint should never be placed at an 
instruction that is modified during execution. 

3. If the teletype busy flags are set upon breakpoint 
entry, Debug 11 will wait until they have been 
cleared before taking control. If TTI Busy is set 
and a tape is not mounted in the reader or a key 
is not depressed, Debug II will loop continuously. 



If adr is not specified, Debug II will transfer to an 
address which the user must initialize in the starting 
location register. This register is opened for 
modification by the command: 



To return control to the user routine after a break- 
point, the user can give the command: 



|nj P 



where: n is an unsigned integer indicating the number 
of times the breakpoint instruction is to be 
encountered before another break occurs 
returning control to Debug II. 

If n is not given, a trap will occur the first time 
the breakpoint is encountered. 

Note that the count for the P (or Proceed) command 
applies only to the breakpoint that causes transfer 
to Debug 11. It is possible to set the break proceeil 
counts for the other breakpoints using the breakpoint count 
registers. There are four breakpoint count registers, 
opened using the command: 



n N 
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RUN COMMANDS (cont'd) 

where: n is tie number (0 through 3) of the breakpoint. 

The contents of each breakpoint count register indicate 
the number of times the instruction having that break- 
point can be executed before a transfer to Debug II 
occurs. The user can set or modify the proceed count 
for any breakpoint except the one he intends to proceed 
from. The argument to the P command unconditionally 
overwrites any count in the count register for that 
breakpoint. 



1557B user sets breakpoint at 1557 and checks 

L / 001000/ contents of L register, starting 
R execution at that address. 

01011 «7 ui 

000100 000040 000011 000017 

Debug II prints out breakpoint and 
contents of accumulators at the break. 

1230 / 015731* user examines locations 1230 and 1231, 
004020 004035J changing contents of 1231. 



3D 

P 



user deletes breakpoint 3 but proceeds 
with execution from the instruction 
that contained that breakpoint. 



3134 B2 

000241 001115 000777 000025 

Control is returned to Debug II at 

another breakpoint. 

IN 000020/ iy User changes the break proceed 

15P counter for breakpoint 1, and proceeds 

with execution from breakpoint 2, allowing 
14 passes through breakpoint 2. 



PUNCH COMMANDS 

Debug II allows the user to punch binary tapes of ranges 
of memory. In this mode it performs a function 
identical to the Binary Punch Program (document 
093-000001). 

The user selects the output device to be used for 
punching by setting the contents of the punch device 
register. The punch device register is opened for 
examination and modification by the command: 



H 



If the output device is to be the teletype punch, the 
register should be set to 0; if the output device is to 
be the high speed punch, the register should be set to 
1. 



PUNCH COMMANDS (cont'd) 



To punch blank leader or trailer tape on the output 
device, the user gives the command: 



nF 



where: n is the number of inches (in octal) of 
leader to be punched. 

The command determining the range of memory 
to be punched is : 



adr. , adr ? P 



where: adr. is the first location to be punched and 
adr, is the last location to be punched. 

adr must be less than or pqusl to adr. . 

An End Block (also called a Start Block) can be 
punched using the command: 



[adrJE 



where: 



the optional argument adr is the address 
to which the Binary Loader will transfer 
control after reading the block. 

If no adr is given, the Binary Loader will 
halt after reading the block and the user 
can manually insert the starting address. 



A problem arises when using Debug II in punch mode 
with the teletype as the output device. Since the 
teletype is used both for command input and for 
output, if the punch is left in the "ON" position 
while typing Debug II commands, these characters 
will be punched as part of the output. 

Debug II resolves the problem in the following way. 
After the punch command is given, Debug II will 
HALT with the Carry light on. This signals the 
user to turn the punch ON and press CONTINUE 
on the console, causing the output to be punched. 
When the punching operation is complete, Debug II 
will again HALT but with the Carry light off . This 
signals the user to turn the teletype punch OFF 
and press CONTINUE on the console. Additional 
Debug II commands can then be given. The 
signaling process by Debug II will be repeated as 
many times as is necessary. 
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EXPRESSION EVALUATION 

Debug II can be used to perform simple desk calculator 
operations by using the special command: 



exprcssion= 



where: expression follows the format for argument 
expressions: 

octal no. + octal no. + . . . 

and octal numbers may be replaced by 
either the special character $ (contents of the 
current location) or the special character . 
(most recently closed location. ) 

Debug II will respond with the result of evaluation in 
octal immediately following the = sign. 



561 -472+3 - 5 = 65 

.= 007567 «- if 7567 was the address of the most 
recently closed memory register 

.+$ = 007777 «- if 7567 was the address of the most 
recently closed memory register 
and if the contents of the most 
recently closed register (not 
necessarily memory) were 210. 



OPERATING PROCEDURE 

There are two absolute binary tapes of Debug II 
provided as part of the standard Nova family 
software package. Debug II is loaded using the 
Binary Loader, following standard loading pro- 
cedure. (See Binary Loader manual, 093-000$(/)3. ) 

One binary tape will load into locations 400 to 1777; 
the other loads into locations 6200 to 7577. Debug 
II also requires locations 10 to 13 of page 
zero. 

A relocatable binary tape of Debug II is provided 
to users who wish to use relocatable loading of 
Debug II. 

If control is lost during the testing process, Debug 
II can be restarted at the starting location of 
the particular version being used (400 or 6200). 
Restarting will cause the contents of the accumulators 
to be printed and the I (Interrupt Enable) and T 
(TTY Done) registers to be cleared. All other 
Debug II registers and the breakpoint locations 
will remain unchanged. 
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USER'S MANUAL 
COMMAND SUMMARY 
Special Register Commands 

A Print the contents of all accumulators. 

nA Open and print the contents of accumulator n. (n = - 3) 

C Open and print contents of Carry register, (Carry set = 1 ; Carry reset = 0. ) 

H Open and print contents of the Punch Device register. (TTP = 0; PTP =1). 

I Open and print contents of the Interrupt Enable register. (Enabled = 1; disabled = 0). 

L Open and print contents of the Starting Location register. (See Execute Commands . ) 



M 

-iM 



Open and print contents of the Mask register. (See Search Memory Commands . ) 
wpen and print contents of Breakpoint Count register n. (n = - 3). 



T Open and print contents of TTY Done register. (If bit 14 is set, TTI done; if bit 15 set, TTO done.) 

W Open and print contents of Word register. (See Search Memory Commands . ) 

1 Close an open special register. 

Memory Register Commands 

adr/ Open and print contents of memory location adr . 
adr! Open memory location adr. 

^ Close an open memory register. 

* Close an open memory register and open the succeeding register, 

t Close an open memory register and open the preceding register. 

Search Memory Commands 

_n, mS Search contents of memory from address n to address m inclusive, matching contents of the 
location ANDed with contents of the Mask register to the contents of the Word register. 

Breakpoint Commands 

B Print out all breakpoints and their contents. 

adrB Set a breakpoint at location adr of the user program. 

D Delete all breakpoints. 

nD Delete breakpoint n. (n = - 3). 

Execute Commands 

R Execute user program from location given in the Starting Location register. 

adrR Execute user program from location adr . 

[n]P Proceed with execution of the user program from the instruction containing the last breakpoint. 

Execution will halt when the breakpoint is again encountered unless the integer argument n is 
given, indicating the number of times the breakpoint may be encountered before execution halts. 

Punch Commands 

nF Punch blank leader or trailer tape. 

adr . adr, P Punch range of memory from adr, to adr , . 
[ adr] E Punch an end block. 

Expression Evaluation 

exp= Evaluate expression exp and print the resultant octal value. 
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CHANGES FROM REVISION 1 TO REVISION 2 OF DEBUG II 
Page 1 Contents of Carry register, when set, are 000001. 

Page 7 Punch commands are included in the command summary. 
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